home *** CD-ROM | disk | FTP | other *** search
/ Best of www.BestZips.com (Collector's Edition) / Best of WWW.BESTZIPS.COM Collector's Edition (JCSM Shareware) (JCS Marketing).ISO / prgtools / euphor14.zip / ED.DOC < prev    next >
Text File  |  1996-05-17  |  10KB  |  208 lines
  1.            +-----------------------+
  2.            |  The Euphoria Editor  |
  3.            +-----------------------+
  4.  
  5.  usage: ed filename
  6.      ed
  7.  
  8.  Summary
  9.  -------
  10.  After any error, just type "ed", and you'll be placed in the editor, at the 
  11.  line and column where the error was detected. The error message will be at 
  12.  the top of your screen.
  13.  
  14.  .e, .ex and .pro files are displayed in color. Other text files are in mono. 
  15.  You'll know that you have misspelled something when the color does not change
  16.  as you expect. Keywords are blue. Names of routines that are built in to 
  17.  ex.exe appear in magenta. Strings are brown, comments are red, most other 
  18.  text is black. Balanced brackets (on the same line) have the same color.
  19.  You can change these colors as well as several other parameters of ed. See 
  20.  "user-modifiable parameters" near the top of ed.ex.
  21.  
  22.  The arrow keys move the cursor left, right, up or down. Most other characters
  23.  are immediately inserted into the file. Non-standard keys on the keyboard are
  24.  ignored.
  25.  
  26.  In Windows, you can "associate" various types of files with ed.bat. You will 
  27.  then be put into ed when you double-click on these types of files - e.g. 
  28.  .e, .pro, .doc etc. Main Euphoria files ending in .ex might better be
  29.  associated with "ex.exe".
  30.  
  31.  Ed is a multi-file/multi-window editor. Esc c will split your screen so 
  32.  you can view and edit up to 10 files simultaneously, with cutting and
  33.  pasting between them. You can also use multiple edit windows to view and edit 
  34.  different parts of a single file. 
  35.  
  36.  Special Keys
  37.  ------------
  38.  <delete>         Delete the current character above the cursor.
  39.  
  40.  <back-space>     Move the cursor to the left and delete a character.
  41.  
  42.  <control-delete> 
  43.       or        Delete the current line. (<control-delete> is not
  44.  <control-d>      available on all systems.)
  45.  
  46.  <insert>         Re-insert the preceding series of deletes or
  47.           control-deletes before the current character or
  48.           current line.
  49.  
  50.  <control-arrow-left>  Move to the start of the previous word.
  51.  
  52.  <control-arrow-right> Move to the start of the next word.
  53.  
  54.  <home>           Move to the beginning of the current line.
  55.  
  56.  <end>            Move to the end of the current line.
  57.  
  58.  <control-home>   Move to the beginning of the file.
  59.  
  60.  <control-end>    Move to the end of the file.
  61.  
  62.  <page up>        Move up one screen.
  63.  
  64.  <page down>      Move down one screen.
  65.  
  66.  F1 ... F10      Select a new current window. The windows are numbered
  67.            from top to bottom, with the top window on the screen
  68.            being F1.
  69.  
  70.  Escape Commands
  71.  ---------------
  72.  Press and release the <Esc> key, then press one of the following keys:
  73.  
  74.  h     Get help text on the editor, or on Euphoria. This operation
  75.       may not work if you are very low on extended memory. 
  76.  
  77.  c     "Clone" the current window, i.e. make a new edit window that is 
  78.       initially viewing the same file at the same position as the
  79.       current window. The sizes of all windows are adjusted to make room
  80.       for the new window. You might want to use Esc l to get more lines
  81.       on the screen. Each window that you create can be scrolled
  82.       independently and each has its own menu bar. The changes that you
  83.       make to a file will initially appear only in the current window.
  84.       When you press an F-key to select a new window, any changes will
  85.       appear there as well. You can use Esc n to read a new file into 
  86.       any window.
  87.  
  88.  q       Quit (delete) the current window and leave the editor if there are 
  89.       no more windows. You'll be warned if this is the last window used for
  90.       editing a modified file. Any remaining windows are given more space.
  91.  
  92.  s       Save the file being edited in the current window, then quit the 
  93.       current window as q above.
  94.  
  95.  w     Save the file but do not quit the window.
  96.  
  97.  e       Save the file, and then execute it with ex. When the program finishes
  98.      execution you'll hear a beep. Hit Enter to return to the editor. 
  99.      This operation may not work if you are very low on extended memory.
  100.      You can't supply any command-line arguments to the program.
  101.      
  102.  d     Run any DOS command. After the beep, hit Enter to return to the editor.
  103.      You could also use this command to edit another file and then return,
  104.      but Esc c is probably more convenient.
  105.  
  106.  n     Start editing a new file in the current window. Deleted lines/chars 
  107.       and search strings are available for use in the new file.
  108.  
  109.  f       Find the next occurrence of a string in the current window. When
  110.       you type in a new string there is an option to "match case" or
  111.       not. Press y if you require upper/lower case to match. Keep hitting 
  112.       Enter to find subsequent occurrences. Any other key stops the search. 
  113.       To search from the beginning, press <control-Home> before Esc f.
  114.      The default string to search for, if you don't type anything,
  115.      is shown in double quotes.
  116.      
  117.  r     Globally replace one string by another. Operates like f command.
  118.      Keep hitting Enter to continue replacing. Be careful -- there is
  119.      no way to skip over a possible replacement.
  120.      
  121.  l     Change the number of lines displayed on the screen. Only certain
  122.      values are allowed, depending on your video card. Many cards will
  123.      allow 25, 28, 43 and 50 lines. 
  124.  
  125.  ddd     Move to line number ddd. e.g. Esc 1023 Enter would move to 
  126.       line 1023 in the file.
  127.  
  128.  CR      Esc <Enter> will tell you the name of the current file, as well as
  129.        the line and character position you are on, and whether the file 
  130.        has been modified since the last save. If you press Esc and then
  131.        change your mind, it is harmless to just hit Enter so you can go back
  132.        to editing.
  133.  
  134.  Cutting and Pasting
  135.  -------------------
  136.  When you <control-delete> a series of consecutive lines, or <delete> a 
  137.  series of consecutive characters, you create a "kill-buffer" containing 
  138.  what you just deleted. This kill-buffer can be re-inserted by moving the
  139.  cursor and then pressing insert. 
  140.  
  141.  A new kill-buffer is started, and the old buffer is lost, each time you 
  142.  move away and start deleting somewhere else. For example, cut a series of 
  143.  lines with <control-delete>. Then move the cursor to where you want to paste
  144.  the lines and press <insert>. If you want to copy the lines, without 
  145.  destroying the original text, first <control-delete> them, then immediately
  146.  press <insert> to re-insert them. Then move somewhere else and press 
  147.  <insert> to insert them again, as many times as you like. You can also 
  148.  <delete> a series of individual *characters*, move the cursor, and then paste
  149.  the deleted characters somewhere else. Immediately press <insert> after 
  150.  deleting if you want to copy without removing the original characters.
  151.  
  152.  Once you have a kill-buffer, you can type Esc n to read in a new file, or you
  153.  can press an F-key to select a new edit window. You can then insert your kill
  154.  buffer.
  155.  
  156.  Use of Tabs
  157.  -----------
  158.  The standard tab width on MS-DOS is 8 spaces. The editor assumes tab=8 for 
  159.  most files. However, it is more convenient when editing a program for a 
  160.  tab to equal the amount of space that you like to indent. Therefore you will
  161.  find that tabs are set to 4 when you edit Euphoria files (or .c, or .h 
  162.  or .bas files). The editor converts from tab=8 to tab=4 when reading your 
  163.  program file, and converts back to tab=8 when you save the file. Thus your
  164.  file remains compatible with the tab=8 world, e.g. MS-DOS PRINT, EDIT, etc.
  165.  If you would like to choose a different number of spaces to indent, change
  166.  the line at the top of ed.ex that says "constant PROG_INDENT = 4".
  167.  
  168.  Lines longer than 80 characters
  169.  -------------------------------
  170.  Lines longer than 80 are marked with an inverse video character in the
  171.  80th column. Ed will not display past column 80. By deleting the carriage 
  172.  return at the end of a line, you can combine it with the next line to create
  173.  a line longer than 80. You can also break a long line by inserting a 
  174.  carriage return.
  175.  
  176.  Maximum File Size
  177.  -----------------
  178.  Like any Euphoria program, ed can use extended memory. It will edit files 
  179.  that are much larger than what MS-DOS EDIT or Windows Notepad can handle.
  180.  With a huge file, inserting or deleting a line near the beginning of the file
  181.  might take 20 seconds or longer, due to intense swapping activity. Other 
  182.  operations should be reasonably quick.
  183.  
  184.  Non-text Files
  185.  --------------
  186.  ed is designed for editing pure text files, although you can use it to
  187.  view other files. As ed reads in a file, it replaces non-printable 
  188.  characters (less than ASCII 32) with ASCII 254 - small square. If you 
  189.  try to save a non-text file you will be warned about this. (MS-DOS EDIT
  190.  will quietly corrupt a non-text file - do not save!). Since ed opens all
  191.  files as "text" files, the control-Z character (26) will appear to be the
  192.  end of the file.
  193.  
  194.  Windows 95 Long Filenames
  195.  -------------------------
  196.  You can edit existing files that have pathnames with long names in them, 
  197.  however in this release ed will not create *new* files with long names. The 
  198.  name will be truncated to the standard DOS 8.3 length.
  199.  
  200.  Source Code
  201.  -----------
  202.  The complete source code to this editor is in bin\ed.ex and bin\syncolor.e. 
  203.  You are welcome to make improvements. There is a section at the top of
  204.  ed.ex containing "user-modifiable" configuration parameters that you
  205.  may want to adjust. The colors and the cursor size may require adjusting for
  206.  some operating environments.
  207.  
  208.